Ad Rotator 元件參考

    Ad Rotator元件建立一個Ad Rotator對象，該對像在Web頁上自動輪換顯示廣告圖像。當用戶每次打開或重新加載Web頁時，Ad Rotator元件將根據在Rotator Schedule文件中指定的訊息顯示一個新廣告。

　　可以記錄每個廣告被多少個用戶單擊訪問，方法是在Rotator Schedule文件中設置一個URL參數，將用戶定向到重定向文件中。如果指定了此參數，那麼當每次跳轉到一個廣告客戶的URL時，都會在Web伺服器的活動日誌中作相應的記錄。關於活動日誌的詳細訊息，請參閱記錄Web站點活動。

　　文件名

　　adrot.dll Ad Rotator元件。

　　重定向文件 可選文件，用於實現重定向並允許Ad Rotator元件記錄每個廣告被多少個用戶單擊訪問。

　　Rotator Schedule文件文本文件，包含廣告的顯示計劃和文件訊息。此文件必須在Web伺服器的某個虛擬路徑上可用。
　　
　　語法

　　Set AdRotator = Server.CreateObject(MSWC.AdRotator)

　　參數

　　AdRotator 指定AdRotator對象的名稱，此對像通過調用Server.CreateObject建立。

　　註冊表項

　　無。

　　屬性

　　Border指定廣告邊框的大小。

　　Clickable指定廣告是否為超鏈接。

　　TargetFrame 指定顯示廣告的框架的名稱。

　　方法

　　GetAdvertisement從資料文件中獲取下一個計劃廣告的詳細說明並將其格式化為HTML格式。

　　示例

　　下面的示例在用戶每次查看Web頁時顯示不同的廣告。

　　＜% Set ad = Server.CreateObject(MSWC.AdRotator) %＞
　　＜%= ad.GetAdvertisement(/ads/adrot.txt) %＞

　　下面的HTML由GetAdvertisement方法生成且被添加到網頁的輸出中，以便顯示Rotator Schedule文件中的下一個廣告。

　　＜A HREF=http://www.msn.com/isapi/adredir.asp?http://www.company.com/＞

　　＜IMG SRC=http://msnnt3web/ads/homepage/chlogolg.gif ALT=Check out the new Technology Center WIDTH=440 HEIGHT=60 BORDER=1＞＜/A＞

　　Rotator Schedule文件包含的Ad Rotator元件用於管理和顯示各種廣告圖像的訊息。在該文件中，用戶可以指定廣告的細節，例如廣告的空間大小、使用的圖像文件以及每個文件的顯示時間所佔百分比。

　　Rotator Schedule文件由兩部分組成。第一部分設置應用於輪換安排中所有廣告圖像的參數；第二部分指定每個單獨廣告的文件和位置訊息以及應當接收的每個廣告的顯示時間所佔百分比。這兩部分由全是星號(*)的一行隔開。

　　在第一部分中有四個全局參數，每個參數都由一個關鍵字和值組成。所有的參數都是可選的。如果用戶未指定全局參數的值，則Ad Rotator將使用默認的值。在這種情況下，文件的第一行必須只有一個星號(*)。

　　語法

　　 　　[REDIRECT URL]
　　[WIDTH numWidth]
　　[HEIGHT numHeight]
　　[BORDER numBorder]
　　*
　　adURL
　　adHomePageURL
　　Text
　　impressions

　　參數

　　URL

　　指定動態鏈接庫(.dll)或執行重定向的應用程式(.asp)文件的路徑。該路徑必須是完整的(http://MyServer/MyDir/redirect.asp)或相對的虛擬目錄(/MyDir/redirect.asp)。

　　numWidth

　　以像素為單位指定網頁上廣告的寬度。默認值是440個像素。

　　numHeight

　　以像素為單位指定網頁上廣告的高度。默認值是60個像素。

　　numBorder

　　以像素為單位指定廣告四周超鏈接的邊框寬度。默認值是1個像素。如果將該參數設置為0，將沒有邊框。

　　adURL

　　廣告圖像文件的位置。

　　adHomePageURL

　　廣告主頁的位置。如果廣告客戶沒有主頁，請在該行寫上一個連字元(-)，指出該廣告沒有鏈接。

　　Text

　　在瀏覽器不支持圖形或關閉圖像功能的情況下顯示的替代文字。

　　impressions

　　從0到4,294,967,295的數，指出廣告的相對權值。

　　例如，如果Rotator Schedule文件包含3個廣告，其impressions分別設為2、3和5，則第一個廣告佔用20%的顯示時間，第二個佔用30%的顯示時間，第三個佔用50%的顯示時間。

　　示例

　　下面的腳本演示是如何使用Rotator Schedule文件顯示各種廣告以及如何包含重定向文件。

　　---ADROT.TXT---
REDIRECT /scripts/adredir.asp
WIDTH 440
HEIGHT 60
BORDER 1
*
http://kabaweb/ads/homepage/chlogolg.gif
http://www.bytecomp.com/
Check out the ByteCompTechnology
Center20
http://kabaweb/ads/homepage/gamichlg.gif
-Sponsored by Flyteworks20
http://kabaweb/ads/homepage/ismodemlg.gif
http:// www.proelectron.com/28.8
internal PC modem, only $99 80
http://kabaweb/ads/homepage/spranklg.gif
http://www.clocktower.com/The
#1 Sports site on the net 10

　　
　　重定向文件是用戶建立的文件。它通常包含用來解析由 AdRotator 對像發送的查詢字元串的腳本並將用戶重定向到與用戶所單擊的廣告所相關的URL。

　　用戶也可以將腳本包含進重定向文件中，以便統計單擊某一特定廣告的用戶的數目並將這一訊息保存到伺服器上的某一文件中。

　　示例

　　下面的示例將用戶重定向到廣告客戶的主頁。

　　---ADREDIR.ASP---

　　＜% Response.Redirect(Request.QueryString(url)) %＞

　　AdRotator 對像有下列屬性：

　　一.Border

　　二.Clickable

　　三.TargetFrame

　　1.Border 屬性允許用戶指定顯示廣告時四周是否帶邊框。

　　語法

　　Border = size

　　參數

　　size

　　指定顯示的廣告四周的邊框寬度。其默認值在 Rotator Schedule 文件的文件頭中設置。

　　示例

　　下面的例子顯示不帶邊框的廣告。

　　＜% Set ad = Server.CreateObject(MSWC.AdRotator) ad.Border = 0 %＞
　　＜%= ad.GetAdvertisement(/ads/adrot.txt) %＞

　　2.Clickable

　　Clickable 屬性允許用戶指定是否將廣告作為超鏈接顯示。

　　語法

　　Clickable = value

　　參數

　　value

　　指定廣告是否為超鏈接。此參數可為下列值之一。默認值是TRUE。值意義:TRUE 將廣告作為超鏈接顯示。

　　FALSE 將廣告不作為超鏈接顯示。

　　示例

　　下面的示例只將廣告作為圖像顯示，而不是作為超鏈接。

　　＜% Set ad = Server.CreateObject(MSWC.AdRotator) ad.Clickable = FALSE %＞
　　＜%= ad.GetAdvertisement(/ads/adrot.txt) %＞

　　3.目標框架

　　TargetFrame 屬性指定鏈接將被裝入的目標框架。該屬性完成的功能等價於 HTML 語句中的 TARGET 參數。

　　語法

　　TargetFrame = frame

　　參數

　　frame

　　指定用來顯示廣告框架的名稱。該參數也可以是一個 HTML 框架關鍵字, 例如 _TOP、_NEW、_CHILD、_SELF、_PARENT 或 _BLANK。默認值是 NO FRAME。

　　示例

　　下面的例子顯示框架 AdFrame中的廣告。

　　＜% Set ad = Server.CreateObject(MSWC.AdRotator) ad.TargetFrame = AdFrame %＞
　　＜%= ad.GetAdvertisement(/ads/adrot.txt) %＞

　　AdRotator 對像只有一個方法.GetAdvertisement

　　GetAdvertisement 方法從 Rotator Schedule 文件中獲取下一個廣告。每次運行腳本時，例如當用戶打開或刷新一頁時，此方法會獲取下一個安排的廣告。

　　語法

　　GetAdvertisement(rotationSchedulePath)

　　參數

　　rotationSchedulePath

　　指定 Rotator Schedule 文件相對於虛擬目錄的位置。例如，若物理路徑為 C:\\Inetpub\\Wwwroot\\Ads\\Adrot.txt（其中Wwwroot 是 / 虛擬目錄）則應指定路徑 \\Ads\\Adrot.txt。

　　返回值

　　返回在當前頁中顯示廣告的 HTML。

　　示例

　　下面的示例從 Adrot.txt 文件中獲取廣告，此文件位於 /Ads/ 虛擬目錄下。

　　＜% Set NextAd = Server.CreateObject(MSWC.AdRotator) %＞

　　＜%= NextAd.GetAdvertisement(/ads/adrot.txt) %＞

文章來自: Tank部落格
引用通告: 查看所有引用 | 我要引用此文章
Tags: Ad Rotator
相關日誌: